home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 101_200 / DISK0163 / DISK0163.ZIP / TRANSLIT.DOC < prev    next >
Text File  |  1983-08-22  |  3KB  |  87 lines
  1.  
  2.      TRANSLIT (Character Translation Filter)
  3.      Command
  4.     
  5.      --------------------------------------------------
  6.      Purpose:  This is a filter that reads a file from 
  7.                the standard input device, translates 
  8.                specified characters into others, and
  9.                writes the translated text to the 
  10.                standard output device.
  11.  
  12.  
  13.      Format:   TRANSLIT from to
  14.  
  15.  
  16.      Type:     Internal  External
  17.                            ***
  18.  
  19.      Remarks:   The parameters 'from' and 'to' are strings 
  20.                 of characters, a given character in 'from'
  21.                 will be translated into the corresponding
  22.                 character in the to string.
  23.                  
  24.                 To specify a range of characters
  25.                 to be converted you may type char-char 
  26.                 (see examples and note below).
  27.                  
  28.                 To specify non-printing characters such
  29.                 as <cr>,<lf> or <tab> one may use the
  30.                 following escape sequences (the leading
  31.                 \ tells translit that the following is 
  32.                 to be interpreted as a special character).
  33.  
  34.                     \f  form feed
  35.                     \b  back space
  36.                     \n  line-feed
  37.                     \t  tab
  38.                     \s  space
  39.                     \\  back slash character itself
  40.                     \!  exclamation mark
  41.                     \r  carriage return     
  42.                     \0  ASCII null 
  43.                 
  44.                 To specify that all characters not in 
  45.                 the given set of from characters are to
  46.                 be translated to a given character,
  47.                 precede the list of characters with an
  48.                 exclamation mark (!)( see example below).
  49.  
  50.              
  51.      Examples:  A>TRANSLIT a-z A-Z <translit.doc
  52.  
  53.                 Will display this file, with all the
  54.                 lower case letters in it converted to 
  55.                 upper case.Or,
  56.                  
  57.                 A>TRANSLIT \s\t\n \n <translit.doc 
  58.                     >transl.wrd
  59.                  
  60.                 will produce a list of all the words in
  61.                 this file, listed one per line, in the
  62.                 file transl.wrd. 
  63.                  
  64.                 A>TRANSLIT !\n\r\sA-Za-z0-9 \s <translit.
  65.                     doc >transl.npu
  66.                  
  67.                 Will make the file transl.npu containing
  68.                 this document with all the punctuation
  69.                 marks removed.
  70.      
  71.      Note:      1.  When specifying ranges of characters
  72.                     both characters must be upper-case 
  73.                     letters, lower-case letters or
  74.                     digits. The first character must also
  75.                     be the predecessor of the second, in
  76.                     lexical order. Thus a-s, 2-5 or W-Y are 
  77.                     legal, but A-z , 9-1 and x-e are not 
  78.                     legal.
  79.                      
  80.                 2.  If the to string is shoreter than
  81.                     the from string, then the excess
  82.                     characters in from will all be translated
  83.                     to the last character of to.
  84.                     
  85.  
  86.                Written by Michael Hanson
  87.